home *** CD-ROM | disk | FTP | other *** search
/ Apple Developer Connection Student Program / ADC Tools Sampler CD Disk 3 1999.iso / Cool Demos, SDKs, & Tools / Demos⁄Tools⁄Offers / Script Compiler / Script Compiler Release Notes < prev   
Text File  |  1999-05-24  |  6KB  |  138 lines
  1. ========================================================================
  2. Script Compiler Release Notes
  3. ========================================================================
  4.  
  5. Version: CW Pro 5
  6. Date:    May 24, 1999
  7. Author:  Josef W. Wankerl
  8. ========================================================================
  9.  
  10. This directory contains a preliminary version of the Script Compiler.
  11. The Script Compiler was written during my spare time for fun and is not
  12. intended to be a robust full-featured scripting environment.
  13. Nevertheless, it's still a pretty nifty tool and I find it to be quite
  14. useful.
  15.  
  16. One of the more "interesting" things you can do is use an external
  17. editor, such as Script Editor, to edit your scripts.  Make an alias of
  18. Script Editor and rename it to "External Editor" and place it in the
  19. (Helper Apps) folder.  Then turn on the Use External Editor checkbox in
  20. the IDE preferences.  The Script Editor doesn't send Apple Events to
  21. the IDE, so after you modify a file, be sure you choose the "Synchronize
  22. Modification Dates" menu item from the IDE project menu.
  23.  
  24. Metrowerks does not currently offer technical support for this product.
  25.  
  26.  
  27. ========================================================================
  28. Preliminary documentation
  29. ========================================================================
  30.  
  31. The Script Compiler is a full-featured OSA-compliant script compiler.
  32. By default, files ending with ".script" are mapped to the script
  33. compiler.  If you desire, you can change this setting in the File
  34. Mappings preference panel.
  35.  
  36. To get quickly up and running, use the AppleScript stationery item to
  37. begin a project.
  38.  
  39. When you are working with a script project, the "debugging dots" column
  40. in the project window control whether or not your compiled script can be
  41. decompiled back into source code.  When a dot is in the debugging column
  42. for a script source code file, a decompile (or disassembly) is possible.
  43.  
  44. There are two preference panel specific to the script compiler.
  45.  
  46. The Script Language panel lets you set which OSA scripting language is
  47. used to compile source code.  The most common OSA scripting language is
  48. AppleScript, and that's probably what you'll use.  The script compiler
  49. is versatile enough to support any OSA language which is compilable.
  50.  
  51. The Script Target panel lets you set properties of the compile script
  52. output file.  The Script Target panel has several options:
  53.  
  54. Project Type:  Compiled
  55. When the project type item is set to Compiled, the resulting file is a
  56. "compiled script" file.  The three suboptions for compiled script files
  57. are:
  58.  
  59.   o File Name - This is the filename given to the compiled script.
  60.  
  61.   o Creator - This is the creator code given to the compiled script.
  62.     Some useful values to put in this field are "ToyS" for Script Editor
  63.     and "MWrs" for the supplied Run Script helper application.
  64.  
  65.   o Description - The description popup lets you set how a description
  66.     is added to the output file.  If the setting is None, no
  67.     descriptive text is added to the ouput file.  If the setting is Use
  68.     ".desc" file, the first file in the project with a ".desc"
  69.     extension is used for the descriptive text.
  70.  
  71. Project Type:  Application
  72. When the project type item is set to Application, the resulting file is
  73. an applet or droplet file.   The four suboptions for applets are:
  74.  
  75.   o File Name - This is the filename given to the compiled applet.
  76.  
  77.   o Stay Open - This controls what happens when the applet finishes its
  78.     main execution path.  When this item is set, the applet does not
  79.     automatically quit when it is finished.
  80.  
  81.   o Never Show Startup Screen - This controls what happens when the
  82.     applet first begins execution.  When this item is set, the standard
  83.     startup screen for applets will not be shown.
  84.  
  85.   o Description - The description popup lets you set how a description
  86.     is added to the output file.  If the setting is None, no
  87.     descriptive text is added to the ouput file.  If the setting is Use
  88.     ".desc" file, the first file in the project with a ".desc"
  89.     extension is used for the descriptive text.
  90.  
  91.  
  92. ========================================================================
  93. New Features in This Version
  94. ========================================================================
  95.  
  96. *  None.
  97.  
  98.  
  99. ========================================================================
  100. Bugs Fixed in This Version
  101. ========================================================================
  102.  
  103. *  None.
  104.  
  105.  
  106. ========================================================================
  107. Known Bugs and Incompatibilities
  108. ========================================================================
  109.  
  110. *  No syntax hilighting for script lanugages is in the IDE.
  111.  
  112. *  No debugging support for scripts -- I'm still thinking about it.
  113.  
  114. *  While you can place multiple .script files in a project, only the
  115.    first in the link order is used when writing out the final script.
  116.    Currently there is no known workaround for this.  If you have any
  117.    ideas on how multiple .script files in a project should work, by all
  118.    means let me know.
  119.  
  120.  
  121. ========================================================================
  122. Contacting Metrowerks
  123. ========================================================================
  124.  
  125. For bug reports, technical questions, and suggestions, please use the
  126. forms in the Release Notes folder on the CD, and send them to
  127.  
  128. support@metrowerks.com
  129.  
  130. See the CodeWarrior on the Nets document in the Release Notes folder for
  131. more contact information, including a list of Internet newsgroups,
  132. online services, and patch and update sites.
  133.  
  134. ========================================================================
  135.  
  136. Josef W. Wankerl
  137. Quality Assurance
  138. Metrowerks Corporation